home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / uux.z / uux
Encoding:
Text File  |  2002-10-03  |  7.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4. UUUUUUUUXXXX((((1111CCCC))))                                                                UUUUUUUUXXXX((((1111CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      uux - UNIX-to-UNIX system command execution
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      uuuuuuuuxxxx [ options ] command-string
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _u_u_x will gather zero or more files from various systems, execute a
  16.      command on a specified system and then send standard output to a file on
  17.      a specified system.
  18.  
  19.      NOTE:  For security reasons, most installations limit the list of
  20.      commands executable on behalf of an incoming request from _u_u_x, permitting
  21.      only the receipt of mail (see _m_a_i_l(1)).  (Remote execution permissions
  22.      are defined in ////eeeettttcccc////uuuuuuuuccccpppp////PPPPeeeerrrrmmmmiiiissssssssiiiioooonnnnssss.)
  23.  
  24.      The _c_o_m_m_a_n_d-_s_t_r_i_n_g is made up of one or more arguments that look like a
  25.      shell command line, except that the command and file names may be
  26.      prefixed by _s_y_s_t_e_m-_n_a_m_e!!!!.  A null _s_y_s_t_e_m-_n_a_m_e is interpreted as the local
  27.      system.
  28.  
  29.      File names may be one of
  30.  
  31.           (1)  a full path name;
  32.  
  33.           (2)  a path name preceded by ~~~~_x_x_x where _x_x_x is a login name on the
  34.                specified system and is replaced by that user's login
  35.                directory;
  36.  
  37.           (3)  anything else is prefixed by the current directory.
  38.  
  39.      As an example, the command
  40.  
  41.           uux "!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 > !~/dan/file.diff"
  42.  
  43.      will get the _f_i_l_e_1 and _f_i_l_e_2 files from the ``usg'' and ``pwba''
  44.      machines, execute a _d_i_f_f(1) command and put the results in _f_i_l_e._d_i_f_f in
  45.      the local PUBDIR/dan/ directory.
  46.  
  47.      Any special shell characters such as <<<<>>>>;;;;|||| should be quoted either by
  48.      quoting the entire _c_o_m_m_a_n_d-_s_t_r_i_n_g, or quoting the special characters as
  49.      individual arguments.
  50.  
  51.      _u_u_x will attempt to get all files to the execution system.  For files
  52.      that are output files, the file name must be escaped using parentheses.
  53.      For example, the command
  54.  
  55.           uux a!cut -f1 b!/usr/file \(c!/usr/file\)
  56.  
  57.      gets /usr/file from system "b" and sends it to system "a", performs a _c_u_t
  58.      command on that file and sends the result of the _c_u_t command to system
  59.      "c".
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. UUUUUUUUXXXX((((1111CCCC))))                                                                UUUUUUUUXXXX((((1111CCCC))))
  71.  
  72.  
  73.  
  74.      _u_u_x will notify you if the requested command on the remote system was
  75.      disallowed.  This notification can be turned off by the ----nnnn option.  The
  76.      response comes by remote mail from the remote machine.
  77.  
  78.      The following _o_p_t_i_o_n_s are interpreted by _u_u_x:
  79.  
  80.      ----         The standard input to _u_u_x is made the standard input to the
  81.                _c_o_m_m_a_n_d-_s_t_r_i_n_g.
  82.  
  83.      ----aaaa_n_a_m_e    Use _n_a_m_e as the user identification replacing the initiator
  84.                user-id.  (Notification will be returned to the user.)
  85.  
  86.      ----bbbb        Return whatever standard input was provided to the _u_u_x command
  87.                if the exit status is non-zero.
  88.  
  89.      ----cccc        Do not copy local file to the spool directory for transfer to
  90.                the remote machine (default).
  91.  
  92.      ----CCCC        Force the copy of local files to the spool directory for
  93.                transfer.
  94.  
  95.      ----gggg_g_r_a_d_e   _G_r_a_d_e is a single letter/number; lower ASCII sequence
  96.                characters will cause the job to be transmitted earlier during
  97.                a particular conversation.
  98.  
  99.      ----jjjj        Output the jobid ASCII string on the standard output which is
  100.                the job identification.  This job identification can be used by
  101.                _u_u_s_t_a_t to obtain the status or terminate a job.
  102.  
  103.      ----nnnn        Do not notify the user if the command fails.
  104.  
  105.      ----pppp        Same as -:  The standard input to _u_u_x is made the standard
  106.                input to the _c_o_m_m_a_n_d-_s_t_r_i_n_g.
  107.  
  108.      ----rrrr        Do not start the file transfer, just queue the job.
  109.  
  110.      ----ssss_f_i_l_e    Report status of the transfer in _f_i_l_e.
  111.  
  112.      ----xxxx_d_e_b_u_g__l_e_v_e_l
  113.                Produce debugging output on the standard output.  The
  114.                _d_e_b_u_g__l_e_v_e_l is a number between 0 and 9; higher numbers give
  115.                more detailed information.
  116.  
  117.      ----zzzz        Send success notification to the user.
  118.  
  119. FFFFIIIILLLLEEEESSSS
  120.      /var/spool/uucp          spool directories
  121.      /etc/uucp/Permissions    remote execution permissions
  122.      /etc/uucp/*              uucp system data files
  123.      /usr/lib/uucp/*          uucp administrative programs
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. UUUUUUUUXXXX((((1111CCCC))))                                                                UUUUUUUUXXXX((((1111CCCC))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      cut(1), mail(1), uucp(1C), uustat(1C).
  142.  
  143. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  144.      Only the first command of a shell pipeline may have a _s_y_s_t_e_m-_n_a_m_e!!!!.  All
  145.      other commands are executed on the system of the first command.
  146.      The use of the shell metacharacter **** will probably not do what you want
  147.      it to do.  The shell tokens <<<<<<<< and >>>>>>>> are not implemented.
  148.  
  149.      The execution of commands on remote systems takes place in an execution
  150.      directory known to the _u_u_c_p system.  All files required for the execution
  151.      will be put into this directory unless they already reside on that
  152.      machine.  Therefore, the simple file name (without path or machine
  153.      reference) must be unique within the _u_u_x request.  The following command
  154.      will NOT work:
  155.  
  156.           uux "a!diff b!/usr/dan/xyz c!/usr/dan/xyz > !xyz.diff"
  157.  
  158.      but the command
  159.  
  160.           uux "a!diff a!/usr/dan/xyz c!/usr/dan/xyz > !xyz.diff"
  161.  
  162.      will work.  (If _d_i_f_f is a permitted command.)
  163.  
  164. BBBBUUUUGGGGSSSS
  165.      Protected files and files that are in protected directories that are
  166.      owned by the requestor can be sent in commands using _u_u_x.  However, if
  167.      the requestor is root, and the directory is not searchable by "other",
  168.      the request will fail.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.